Advisor Tool（顾问工具）

概述

Anthropic Claude API 的 Advisor 模式是一种服务端多模型协作机制，允许在单次 HTTP 请求内部由廉价模型（Sonnet/Haiku）执行主任务，在关键时刻调用昂贵模型（Opus）进行策略审阅，实现接近 Opus 质量、接近 Sonnet 成本的效果。

关键内容

1. 核心设计哲学：打破多模型协作必须多次 HTTP 往返的惯例。传统框架（LangGraph、AutoGen）需要 N 次网络往返，而 Advisor 模式在单次 /v1/messages 请求内部完成 Executor→Advisor→Executor 的完整协作流程。

2. 触发流程：

3. Executor 生成文本时触发 server_tool_use(name="advisor")
4. 服务端将完整 transcript（system+tools+history）发给 Advisor（Opus）
5. Advisor 使用扩展思维独立推理，流式暂停但发送 keepalive pings
6. Advisor 返回 advisor_tool_result（仅最终建议文本，不含 thinking blocks）

7. Executor 接收建议后继续流式生成

8. 关键设计决策：

9. input: {} 永远为空：Advisor 自动获得完整上下文，不允许 Executor"选择性隐瞒"，防止 prompt injection 链路
10. Thinking blocks 被丢弃：仅返回 400-700 tokens 的建议文本，防止 Executor 被推理过程干扰，保持自主性

11. 信息对称设计：Advisor 比 Executor 信息更全，但 Executor 看不到 Advisor 的推理链

12. advisor_redacted_result 加密变体：返回 encrypted_content 字段，客户端无法读取但必须原样传回，服务端解密后注入 Executor 上下文。用于企业 ZDR 场景和敏感建议隔离。

13. 三层设计意图：

14. 协议层：一次请求内部完成多模型协作，无网络往返延迟
15. 认知层：Advisor 是"策略审阅器"而非"另一个执行者"，只给高层建议

16. 经济层：昂贵模型只做关键决策，廉价模型完成 bulk generation

17. 正确使用模式：需正确处理两种变体（advisor_result 可读 vs advisor_redacted_result 不可读），并在后续请求中原样传回加密内容。

来源

• advisor_deep_analysis — Anthropic Advisor Tool 底层逻辑深度分析

相关

• 扩展思维 — uses
• 工具与框架 — part_of
• 零数据保留 — relates_to